home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / programming / aros / intuition / activatewindow.c next >
C/C++ Source or Header  |  1996-09-12  |  2KB  |  78 lines
  1. /*
  2.     (C) 1995-96 AROS - The Amiga Replacement OS
  3.     $Id: activatewindow.c,v 1.2 1996/08/29 13:33:30 digulla Exp $
  4.     $Log: activatewindow.c,v $
  5.     Revision 1.2  1996/08/29 13:33:30  digulla
  6.     Moved common code from driver to Intuition
  7.     More docs
  8.  
  9.     Revision 1.1  1996/08/23 17:28:17  digulla
  10.     Several new functions; some still empty.
  11.  
  12.  
  13.     Desc:
  14.     Lang: english
  15. */
  16. #include "intuition_intern.h"
  17.  
  18. extern intui_ActivateWindow (struct Window *);
  19.  
  20. /*****************************************************************************
  21.  
  22.     NAME */
  23.     #include <clib/intuition_protos.h>
  24.  
  25.     __AROS_LH1(void, ActivateWindow,
  26.  
  27. /*  SYNOPSIS */
  28.     __AROS_LHA(struct Window *, window, A0),
  29.  
  30. /*  LOCATION */
  31.     struct IntuitionBase *, IntuitionBase, 75, Intuition)
  32.  
  33. /*  FUNCTION
  34.     Activates the specified window. The window gets the focus
  35.     and all further input it sent to that window. If the window
  36.     requested it, it will get a IDCMP_ACTIVEWINDOW message.
  37.  
  38.     INPUTS
  39.     window - The window to activate
  40.  
  41.     RESULT
  42.     None.
  43.  
  44.     NOTES
  45.     If the user has an autopointer tool (sunmouse), the call will
  46.     succeed, but the tool will deactivate the window right after
  47.     this function has activated it. It is no good idea to try to
  48.     prevent this by waiting for IDCMP_INACTIVEWINDOW and activating
  49.     the window again since that will produce an anoying flicker and
  50.     it will slow down the computer a lot.
  51.  
  52.     EXAMPLE
  53.  
  54.     BUGS
  55.  
  56.     SEE ALSO
  57.     ModiyIDCMP(), OpenWindow(), CloseWindow()
  58.  
  59.     INTERNALS
  60.  
  61.     HISTORY
  62.     29-10-95    digulla automatically created from
  63.                 intuition_lib.fd and clib/intuition_protos.h
  64.  
  65. *****************************************************************************/
  66. {
  67.     __AROS_FUNC_INIT
  68.     __AROS_BASE_EXT_DECL(struct IntuitionBase *,IntuitionBase)
  69.  
  70.     intui_ActivateWindow (window);
  71.  
  72.     /* This comes _after_ intui_ActivateWindow() because the driver
  73.     might want to deactivate the old window first */
  74.     IntuitionBase->ActiveWindow = window;
  75.  
  76.     __AROS_FUNC_EXIT
  77. } /* ActivateWindow */
  78.